home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 9 / The PC-SIG Library on CD ROM - Ninth Edition.iso / 801_900 / DISK0848 / DISK0848.ZIP / JUDY.DOC < prev    next >
Text File  |  1990-06-26  |  66KB  |  1,419 lines

  1.  
  2.   JUDY Documentation Version 2.00
  3.  
  4.  
  5.    ********** WHAT IS JUDY? **********
  6.  
  7.       I have lived with a Judy, a flesh and blood Judy, for many years now.
  8.    She has made life a lot more pleasant and considerably easier. I'm kind
  9.    of an absent-minded guy. My wife, Judy, is a very practical person. She
  10.    manages to keep track of some things which elude me. I've come to depend
  11.    upon her.
  12.  
  13.    What would happen if - God forbid!- we got divorced? The spiritual and
  14.    romantic benefits of marriage would be hard to replace, but how about the
  15.    nagging? Couldn't the constant reminders be performed by a computer?
  16.  
  17.    Of course, they would be performed less artfully than by my real Judy,
  18.    but no less resolutely.
  19.  
  20.    Thus the genesis of JUDY, the Electronic Yenta.
  21.  
  22.    She shares some of my wife's better qualities:
  23.  
  24.      She never forgets:
  25.    All your appointments and commitments for the rest of the century are in
  26.    JUDY's memory. There can be a thousand appointments pending at any one
  27.    time, and an unlimited number recorded in her logs.
  28.  
  29.      She'll go anywhere with you:
  30.    As you use your computer, going from one piece of software to another,
  31.    from one directory to another, from drive to drive, JUDY stays with you,
  32.    waiting in the background, never losing her bearings.
  33.  
  34.      She's slim:
  35.    Since JUDY is always at hand, she must always occupy some RAM. However
  36.    she's kept her weight down to a mere 8K.
  37.  
  38.      She thinks fast:
  39.    Any concurrent program requires a flicker of attention every so often.
  40.    JUDY has been crafted to keep this flicker to a minimum. She uses less
  41.    than one millisecond per second. (Your software will run better than
  42.    99.9 percent of its normal speed.)
  43.  
  44.  
  45.    ********** THE THREE FACES OF JUDY ***********
  46.  
  47.    JUDY consists of three software elements, which are distinct but
  48.    interconnected. Any one can be run alone and be useful, but they are
  49.    far more powerful together.  These three facets are  "JudyK", "JK"
  50.    and the "Lookup Utility."  It might help to think of the first two,
  51.    "JudyK" and "JK", as the conscious and subconscious mind: two very
  52.    different aspects of the same personality. JudyK, whose thoughts are
  53.    frontstage, is analogous to the conscious, while JK, running quietly
  54.    in the background, approximates the subconscious.  As for the Lookup
  55.    Utility, think of it as a special skill that enhances the use of the
  56.    other two facets whenever you need it.
  57.     Page 2
  58.  
  59.  
  60.    JudyK is responsible for large displays and long-range views. Through
  61.    JudyK, JUDY presents you with the full-screen interactive calendar, she
  62.    takes appointments, has editing functions, makes hard-copy, and (invisibly
  63.    to you) goes through your notes and records, doing the daily filing tasks.
  64.    JudyK fills your computer's memory, does her job, them leaves, returning
  65.    her space to the memory pool.
  66.  
  67.    The other facet of JUDY is JK. While JudyK is expansive and full, JK
  68.    is slim and laconic. Unlike JudyK, JK slips into your memory and stays
  69.    there.  Because she occupies memory, she needs to be lean, all function
  70.    and no fat.
  71.  
  72.    The Lookup Utility, called "phone.exe" on your disk, is exactly what
  73.    its title implies.  It is a tool used for looking up items in JUDY's
  74.    files.  Like JudyK, the Lookup Utility fills computer memory while in
  75.    use and relinquishes it upon completion.
  76.  
  77.  
  78.  
  79.    ********** INSTALLING JUDY *********
  80.  
  81.    First things first.  MAKE A COPY OF YOUR DISTRIBUTION DISKETTE, and
  82.    place the original aside for safe keeping.  That way if anything goes
  83.    wrong you will always have an intact copy of the original.  If anything
  84.    happens to your distribution diskette you are out of luck.  We won't
  85.    replace it for free.  (Sorry, but that's the nature of the software
  86.    business.)
  87.  
  88.    Now on to installation. JUDY needs to reside on one of your disks,
  89.    preferably a hard disk.  To install her: pop the copy of your
  90.    distribution disk into your floppy drive, CHANGE TO THAT DRIVE, then
  91.    simply issue the following command at the DOS prompt:
  92.  
  93.          INSTALLJ X:\JUDY
  94.  
  95.    substituting X with the letter of the actual drive upon which you wish
  96.    JUDY to reside.  The INSTALLJ program will copy all necessary files from
  97.    the distribution diskette into the \JUDY directory and create the
  98.    directory if needed.  It will tell you if anything goes wrong.
  99.  
  100.    EXAMPLE:
  101.    Suppose you want JUDY to be in a directory named, suprisingly
  102.    enough, "JUDY" on drive C:, your hard disk.  Then you would put your
  103.    distribution diskette into floppy drive A: (if that's where it goes) and
  104.    issue the two commands:
  105.  
  106.       A:
  107.       INSTALLJ C:\JUDY
  108.  
  109.  
  110.    Of the files it transfers the ones you will absolutely need are
  111.    JUDYK.EXE, JK.COM, and PHONE.EXE.  The JUDY.HLP is for online help.
  112.    If you do not need online help screens, delete it, d if you wish to 
  113.    save some disk space.  Another useful option is JUDY.BAT, which simply
  114.    invokes JUDYK and JK.  You can use it if you wish, or modify it to suit
  115.    your configuration.  It is included merely as an example of how to
  116.    automate JUDY somewhat. (JUDY.DOC is this text, and does not need to be
  117.    kept in the \JUDY directory.)
  118.     Page 3
  119.  
  120.  
  121.    ********** USING JUDY FOR THE FIRST TIME **********
  122.  
  123.    Before actually running JUDY, you should understand the following
  124.    things about how she works.
  125.  
  126.    JudyK prepares the day's agenda for JK. So to use JUDY, you first run
  127.    Judyk and then JK. You can do this automatically with JUDY.BAT: just type
  128.    "JUDY". Or better still, add the two commands
  129.  
  130.       JUDYK
  131.       JK
  132.  
  133.    (in that order), to your AUTOEXEC.BAT file.  This is highly recommended.
  134.    This way JudyK will process any messages lying about in her files, and
  135.    JK will also be aware of them in case it comes time during the day to
  136.    notify you.
  137.  
  138.    VARIATION: if you do not want the full screen display from JudyK
  139.    to pop up every time you boot your computer, substitute the "JUDYK"
  140.    command in your AUTOEXEC file with "JUDYK /Q" for the 'quick' version
  141.    of JUDY with no screen display.
  142.  
  143.    You may also want to modify JUDY.BAT.  Notice that by default this
  144.    batch job first UNloads JK then loads her.  This is because it is upon
  145.    LOADING that JK reads the day's agenda as prepared by JudyK.
  146.  
  147.    If you run JudyK and change today's agenda, JK won't be aware of the
  148.    change until she is loaded again.  The JUDY.BAT file takes care of all
  149.    that.  But if you have OTHER TSRs in memory (other RAM-Resident programs
  150.    like JK) and JK was originally loaded before them, the act of unloading
  151.    JK will leave a gap in memory--which you may not want.  So feel free to
  152.    change the batch job, or change your AUTOEXEC.BAT file (or your habits)
  153.    and load JK.COM last.
  154.  
  155.  
  156.     JUDY'S AREA
  157.  
  158.    JUDY uses a particular directory on a particular disk drive to leave
  159.    notes for herself. If these notes were scattered all over various disks
  160.    and directories, JUDY would have a hard time keeping track of them. We
  161.    need to set aside an area for all of JUDY's files.  It can be in her own
  162.    private directory but it doesn't have to be.  The PREFERRED SETUP is to
  163.    use a directory called \JUDY, as determined by INSTALLJ, so I'll call
  164.    it that.
  165.  
  166.    You select any directory you want during the initialization process
  167.    explained above.
  168.  
  169.    JUDY populates her area during the Initialization process. The \JUDY
  170.    directory holds her four data files (CALENDAR.JK, ADDRESS.JK, EXPENSES.JK,
  171.    IDEAS.JK), as well as "SCRATCH.PAD" and "NOTE.PAD" that she uses herself.
  172.    The Lookup Utility also looks to the directory \JUDY by default for these
  173.    data files.
  174.     Page 4
  175.  
  176.  
  177.    JUDY's three executable files, JUDYK.EXE, JK.COM, PHONE.EXE as well
  178.    as her two batch files JUDY.BAT and WHERE'S.BAT (which she makes) need
  179.    not be in the \JUDY area.  But wherever they are, they must be SOMEWHERE
  180.    IN THE PATH.  They have to be able to find the \JUDY area no matter where
  181.    they or you are. (Your DOS manual explains use of the Path).  So before
  182.    using JUDY on an ongoing basis, change the PATH command in your
  183.    AUTOEXEC.BAT to include the \JUDY directory (or whatever name you gave it
  184.    during initialization, if different).  Then REBOOT YOUR COMPUTER.
  185.  
  186.  
  187.    NOTES TO FLOPPY DISK USERS
  188.  
  189.    Of course floppy disk users must insure that the correct actual disk
  190.    is in the proper drive, but only during daily bootup, and when using
  191.    JUDY's disk functions (JOT and the Lookup Utility).  Hard disk users do
  192.    not have this concern. JUDY will always find her disk and directory.
  193.  
  194.     If you use the wrong disk:
  195.  
  196.    When JOTting, JUDY looks first for her directory. If it is not
  197.    available, she issues a message and allows you to change disks, or cancel.
  198.  
  199.    Her directory could be available on the wrong disk (JUDY's area might be
  200.    the root directory, for instance, which will always be present). In this
  201.    case, JUDY won't complain. Having found her area, JUDY adds another note
  202.    to her scratchpad. (A file called SCRATCH.PAD, which is read, then flushed
  203.    out by JudyK as soon as she boots up.)
  204.  
  205.    If there's no SCRATCH.PAD in her area, JUDY creates a new one. But if
  206.    this SCRATCH.PAD is not on JUDY's disk, JudyK will not find it the next
  207.    morning when you run AUTOEXEC.BAT which (presumably) calls upon JudyK.
  208.    Don't worry. You can add this SCRATCH.PAD to the real one by typing:
  209.  
  210.    COPY B:SCRATCH.PAD + A:SCRATCH.PAD  (if B: is the real JUDY disk.)
  211.    DEL A:SCRATCH.PAD  (to get rid of the accidental scratch.pad)
  212.  
  213.  
  214.          RUNNING JUDYK FOR THE FIRST TIME:
  215.  
  216.    Now it is time to start up JUDY and make her your own. To bring her to
  217.    life, change directories to the \JUDY directory and type "JUDYK". She
  218.    will then ask you a series of simple questions explained in (gory)
  219.    detail below.
  220.  
  221.       Welcome, new JUDY user. Are you ready to install her?
  222.    JUDY asks if you are ready to make sure you know what you're doing
  223.    when you install her. By reading this manual you should be ready.
  224.    typical answer: Y or [Enter]
  225.  
  226.       Sometimes there will be defaults. They look like  [this].
  227.    Whenever possible, JUDY will suggest a sensible answer for each of her
  228.    own questions. She'll present the default answer in a different color,
  229.    and in brackets.
  230.    typical answer: [spacebar], any key at all
  231.     Page 5
  232.  
  233.  
  234.       Your name:
  235.    JUDY wants to know your name. It is very important that you answer this
  236.    question seriously. JUDY won't allow you to change your name later,
  237.    because JUDY belongs to only one person. Almost everything else can be
  238.    changed by running "Judyk/s".
  239.    typical answer: Edith Snitnow
  240.  
  241.       What is your birthday? first the MONTH [1-12]  and the DAY [1-31]
  242.    Just enter the month of your birth. Again, you're advised to take this
  243.    seriously. JUDY uses your birthday to identify you and your files. Using
  244.    your real birthday will make things simpler.
  245.    typical answer: 5  [Enter]
  246.    then           15  [Enter]   (Edith's birthday is May 15th)
  247.  
  248.  
  249.       Set your password, if desired:
  250.    Again BE CAREFUL, answer this seriously. If you feel sensitive about your
  251.    personal schedule, you can install a password into JUDY.  You will have
  252.    to type in this password each time you run JudyK if you supply one.
  253.    Actually you have three options at this point.
  254.    1: You can have NO PASSWORD. Just hit the [Enter] key.
  255.    2: You can type in any PASSWORD (ending it with [Enter]).
  256.    3: You can simply install a PASSKEY. Any of the Function keys,
  257.       Alternate keys, or even Cursor-pad keys will serve as a one-stroke
  258.       password. (No need to hit [Enter].)
  259.    typical answer: popeye (caps don't matter at all)
  260.  
  261.  
  262.       Where is Judy's Area?
  263.    JUDY can be in any directory on any of your disk drives.  If you
  264.    installed her using INSTALLJ as explained above this will be the
  265.    \JUDY directory.  In this case just hit [Enter] in response to this
  266.    question and go onto the next.  If however you were adventurous and
  267.    cavalier and copied the files into some other directory, then hitting
  268.    [Enter] in response to this question will cause JUDY to make a \JUDY
  269.    subdirectory in the current directory (unless of course you are already
  270.    in a \JUDY directory).  If you don't even want JUDY's area to be called
  271.    "JUDY", then type in the drive and path (these must be valid) and the
  272.    subdirectory name, eg: "B:\BIN\UTILS" will force JUDY to copy her own
  273.    files onto the B: drive in the \BIN\UTILS directory regardless of where
  274.    her actual executable files reside. 
  275.    Whatever directory is made, this is where JUDY will look for her own
  276.    files, even if you installed the executable files from the distribution
  277.    diskette somewhere else (by specifying a different path during the use
  278.    of INSTALLJ.BAT).  See the section on "JUDY's AREA", above, for more
  279.    information.
  280.    typical answer: [Enter]
  281.  
  282.      Do you wish to do a detailed configuration right now?
  283.    You have now completed the information necessary to install JUDY
  284.    into your system. At this point you are presented the option of further
  285.    customizing her.  If you care to go on, answer Yes at this point, and
  286.    you'll fall into the JUDY Configuration dialogue, explained in detail
  287.    at the end of this documentation in the appendix.
  288.    typical answer: N or [Enter] (for no)
  289.     Page 6
  290.  
  291.  
  292.    At this point there is a pause while JUDY does some disk work. She
  293.    will establish the JUDY directory if need be and create a series of
  294.    files for various types of data. Please be patient.
  295.  
  296.    You will also be asked if you would like to print out the
  297.    documentation.  If you answer Yes, JUDY will attempt to print out all of
  298.    JUDY.DOC (this file, about 30 pages) to your parallel printer.  Make
  299.    sure this is what you want to do.  If not, hit N for No.
  300.  
  301.  
  302.    ********** JUDY IN THE FOREGROUND **********
  303.  
  304.    After typing JUDY, (or directly invoking JUDYK yourself), you'll see
  305.    her sign on.  Then the calendar display will appear. You will see the
  306.    screen arranged into ten 'windows'--boxes which enclose particular
  307.    functions. In the Month Window, for example, the current month is
  308.    highlighted. Similarly the day of the month is lit in the Day Window.
  309.    On the left side of the screen is today's list of appointments.  As a
  310.    new user, you'll have no appointments, and this box will be empty.
  311.    Get to work! Make some appointments (see the section below on function
  312.    F5 to learn how to add appointments).
  313.  
  314.    Notice that each of the windows has a "button" on it. The button
  315.    corresponds to a function key. When the key is struck , the window is
  316.    activated: it lights up, and its function is engaged.  The even numbered
  317.    function keys activate the buttons on the right, and the odd function
  318.    keys activate the buttons on the left.
  319.  
  320.  
  321.      F1:HELP
  322.        This presents an onscreen help function, should that be
  323.        necessary. Press [F1] for Help then press the key that you want
  324.        help for.  Pressing [Esc], or any Function Key twice, sends you
  325.        home from helpland.  Calling for Help once in this manner changes
  326.        the "button" names from F numbers into actual words.  Hitting [F1]
  327.        again (and then pressing [Esc] to exit) toggles them back to the
  328.        normal F key display.
  329.  
  330.  
  331.      F2:MONTH:
  332.        Activates the Month array. You can now change the currently
  333.        displayed month by using the cursor keys. [Right]/[Left] or 
  334.        [Up]/[Down] move you month by month.  [Home] and [End] jump
  335.        between January and December. You can scroll past December
  336.        into January of the next year, and vice-versa.  Notice how the
  337.        display cascades: changing the month causes a new calendar to
  338.        appear, and a new list of messages.  By hitting the asterisk (*),
  339.        you invoke the Wild Month. (See WILDCARDS below)
  340.  
  341.  
  342.      F4:YEAR:
  343.        Activates the Year window. The years can be scrolled, with the
  344.        [Left]/[Right] keys. Decades scroll with [Up]/[Down]. The display
  345.        cascades as in the Month Window. And as in the other date windows
  346.        the * activates the Wild Year.  See WILDCARDS below.
  347.     Page 7
  348.  
  349.  
  350.      F6:DAY:
  351.        The calendar of days is active. As you scroll, ([Left]/[Right]
  352.        for days, [Up]/[Down] for weeks), the notes for that day appear
  353.        on the left side of the screen. The * will activate the Wild Day.
  354.        See WILDCARDS below.
  355.  
  356.        Note the single-line box around those dates that have no
  357.        appointments, and double-lines around those which do (except
  358.        for recurring appointments made via Wildcards, the Weekly key
  359.        or the Nag key.)
  360.  
  361.  
  362.      F3:NOTES:
  363.        This key opens the Notes Window, displaying the notes for the
  364.        active date. Notes are available for editing in this mode, and
  365.        are expanded from their normal truncated display.
  366.  
  367.        The cursor keys serve as normal editing keys, and you have
  368.        both overwrite and push-to-the-right editing available. Hitting
  369.        the [Insert] key will toggle this back and forth. (The cursor
  370.        shows the current state.)
  371.  
  372.        To delete a note altogether use the [Up]/[Down] arrow keys to
  373.        highlight the note you wish to delete.  Then use [Ctrl]/[End]
  374.        (the two keys together) to kill it. To edit the time of a message
  375.        use the Left key, or [Ctrl][Left], and type in the new time.
  376.  
  377.        To delete a note that was added as a regular occurrence and
  378.        was entered using wildcards or the 'W' key (see WILDCARDS below),
  379.        you first need to re-highlight all the dates on which the note
  380.        occurs, re-issuing the same combinations of wildcards or use of
  381.        the 'W' key as you did when you first added it.  Then highlight
  382.        the note and hit [Ctrl][End].  This assures that ALL occurrences
  383.        of the given note will be deleted.
  384.  
  385.        Hit any other function key to get out of the NOTES window.
  386.  
  387.      F5:ADD:
  388.        This function is used to add appointments to your calendar.
  389.        The entry window will light up.  Appointments are added to the
  390.        currently displayed date.  First fill in the time, (see TELLING
  391.        JUDY THE TIME, below), or just hit [Enter] if you don't want the
  392.        message to pop up at any particular time.  Then enter the message.
  393.  
  394.        If no particular time is associated with a given message, the
  395.        message will be displayed upon invocation of JudyK (usually 
  396.        performed automatically by your AUTOEXEC.BAT file upon booting
  397.        the computer) on the proper date.  Otherwise, the message will
  398.        pop up on the proper date at the time you have indicated.
  399.  
  400.        In any event, however, the new note you add will not be
  401.        subject to automatic announcement until JK.COM has had a chance
  402.        to look at it--which happens only when JK is loaded into memory.
  403.        But this is rarely a problem for appointments you place for the
  404.        future.  When the day in question finally rolls around, JK will
  405.        be loaded up in your AUTOEXEC that day anyhow and the note will
  406.        be detected.
  407.     Page 8
  408.  
  409.  
  410.        If you wish to leave a note for an event for later the SAME
  411.        day you enter it, it's best to use the MEMO option described
  412.        below in the section on "Judy in the Background".
  413.  
  414.        Hit any other function key to exit the ADD window.
  415.  
  416.  
  417.    EXAMPLE:
  418.        Our user, Edith Snitnow, wants to remember to go to a cow
  419.    surgery seminar held on January 13, 1997 at 3 pm.  She uses [F4] and
  420.    the arrow keys to set the year to 1997.  Then she uses the [F2] key
  421.    to highlight January, hits [F6] and then scrolls down to the 13th.
  422.    She then hits [F5] to add the note.  Edith types in 14:00 (or 2:00 pm)
  423.    in order to make the message go off an hour before the meeting.  She
  424.    then types in "Seminar--3 pm!" and hits [Return].  This adds it to the
  425.    list and she exits JUDY.
  426.        When the special day finally comes around, Edith flips on her
  427.    computer and her AUTOEXEC.BAT runs JudyK automatically, which in turn
  428.    displays the message "Upcoming Message For Today: Seminar--3 pm!".
  429.    Later, at 2:00, JK butts into Edith's spreadsheet session and delivers
  430.    the message.  But Edith decides not to go after all, because her 
  431.    interest in cows had diminished slightly in the 7 years she waited for
  432.    the seminar...
  433.  
  434.  
  435.      F7:SEARCH:
  436.        This allows you to find any name or fragment in your
  437.        appointment book (the CALENDAR.JK file, to be exact). Simply type
  438.        in the name, or text fragment you wish to find (pay no attention
  439.        to upper and lower case.  JUDY won't). Then press Enter.  JUDY
  440.        will locate the most recently added appointment containing that
  441.        text and flip the calendar to that date. Pressing [Enter] again
  442.        finds the next occurrence, and so on. (Note that the order of
  443.        the Search is from the most recently added appointment back.)
  444.  
  445.        Any other function key will escape.
  446.  
  447.        To find items in any of the other .JK data files, hit [F8] to
  448.        use the Lookup Utility.
  449.  
  450.    EXAMPLE:
  451.        Edith knows she has had several appointments with Ted Turner in the
  452.    past year but can't remember exactly when or how many.  So she hits [F7]
  453.    and types in "turner" (without the quotes of course).  Upon hitting 
  454.    [Return] JUDY sets the date immediately at the latest appointment date,
  455.    and Edith can see from the Notes window that the message, sure enough,
  456.    says "Ted Turner."
  457.        She hits [Return] again and now JUDY sets the date further back to
  458.    another, earlier, date that has a message concerning "Turner" also.
  459.    Edith keeps doing this until JUDY finally beeps and says that no more
  460.    messages were found.  Astonished that she has had 129 dates with Ted in
  461.    the past 3 months, Edith vows to play it more cautiously in the future...
  462.     Page 9
  463.  
  464.  
  465.    F8:PHONEBOOK: (The Lookup Utility)
  466.       The operation and use of the Lookup Utility is explained in greater
  467.       detail in its own section below.  Hitting [F8] is just a convenient
  468.       way of calling it up.  Upon exit from the Lookup Utility (or whatever
  469.       program you assigned to this [F8] key during the initialization
  470.       process), you will be returned to the calendar display of JudyK.
  471.  
  472.  
  473.      F9:PRINTOUT:
  474.        JUDY lists out the displayed schedule (seen in the F3 window)
  475.        on your parallel printer. The printer type and port should be set during
  476.        initialization.  After printing that day's worth, you are asked whether
  477.        you want a "Page Eject?".  If you want to add appointments from other
  478.        days on the same page, hit N and go to the next date.  You may then
  479.        hit [F9] again and add that day's list to the previous one.  Hitting
  480.        Y in response to "Page Eject" will force a form feed.
  481.  
  482.    EXAMPLE:
  483.        Edith and Ted are planning to go on a Love Boat cruise to Mexico for
  484.    a week in July and Ted has asked her to mail him a copy of the itinerary,
  485.    which Edith has entered on JUDY.
  486.        Edith first highlights the date of the first day of the cruise.
  487.    Making sure her printer is on and ready, she then hits [F9].  JUDY
  488.    immediately sends that date's itinerary to the printer and asks "Page
  489.    Eject?"   Edith responds N for no, and moves on to the next day.  She
  490.    hits [F9] to print, and N again to hold off on the page eject.  She
  491.    does this for each day of the cruise and finally hits Y to finish the
  492.    list and eject the page.
  493.        Upon receipt of the itinerary Ted calls Edith and passionately
  494.    proposes they spend an extra month in Mexico...
  495.  
  496.  
  497.    F10:EXIT:
  498.       Return to DOS saving all changes to disk.  This means that whatever
  499.       new appointments you have added or deleted will be written to the
  500.       CALENDAR.JK file in JUDY's area immediately and control will be
  501.       given back to DOS.
  502.  
  503.  
  504.    ********** WILDCARDS **********
  505.  
  506.    Like DOS, JUDY understands WILDCARDS. She uses them for three parts of
  507.    the date: the day, the month, and the year. This is (obviously) useful
  508.    for various types of regular occurrences. For example:
  509.  
  510.    day/month/*    :every year on this date        :birthday, anniversary
  511.    day/*/year     :this day every month this year :rent/bill payment
  512.    */month/year   :every day of the month         :monthlong project
  513.    */*/year       :every day this year            :long term project
  514.    */month/*      :all month, every year          :seasonal reminder
  515.    day/*/*        :certain day of the month       :paycheck
  516.    */*/*          :every day                      :inspirational message
  517.  
  518.     Page 10
  519.  
  520.  
  521.    So, for example, suppose you wanted to add a reminder to pay a bill
  522.    every 5th of the month, every year.  First hit [F4] to go to the
  523.    YEAR window, then instead of hitting an arrow key to scroll, press
  524.    the asterisk (*) key.  Then hit [F2] to highlight the MONTH window and
  525.    do the same to highlight all the months.  Finally, in the DAY window (F6),
  526.    scroll to the 5th of the month.  With all proper years and months and
  527.    day lit up, use [F5] to add the note as normal.
  528.  
  529.    To delete all occurrences of a given note created with wildcards,
  530.    you must first use the same combination of wildcards as you did
  531.    originally to highlight all the same multiple days, years or months.
  532.    Then go into the NOTES window with [F3], highlight the note and delete
  533.    it with [Ctrl][End].
  534.  
  535.  
  536.      NAG FILE:
  537.    The Nag File is opened by hitting the letter 'N' once in the Day window.
  538.    The Nag File is the list of those things that must get done as soon as
  539.    possible, but not on a particular day. Changing the oil in your car is a
  540.    good example.
  541.  
  542.    The contents of the Nag File are always added to Today's messages,
  543.    and they follow you every day until you finally erase them.
  544.  
  545.    To use the Nag file, first go into the Day window (F6).  Then hit
  546.    the N key.  This opens the file.  Now hit [F5] to add a new entry.
  547.    Type in the entry and hit [Enter] as always.  This (and subsequent
  548.    messages) will now be displayed along with the others in the NOTES
  549.    window every day (but only in the NOTES window).  Once finshed adding
  550.    nag messages, hit [F6] to go to the DAY window and hit the N key this
  551.    time to CLOSE the Nag file.  Or just hit [F10] to exit.
  552.  
  553.    To delete a nag message, FIRST go to the DAY window (F6), open the Nag
  554.    file as usual, then use [F3] to go in and highlight the message(s) you
  555.    wish to kill.  Use [Ctrl][End] as always.  Go to the DAY window and
  556.    close the Nag file before going on and adding new messages.
  557.  
  558.  
  559.      WEEKLY OCCURRENCES:
  560.    Weekly occurrences can be flagged by hitting the 'W' key from within
  561.    the day window. This creates messages that appear every Tuesday, for
  562.    instance, if the cursor was on Tuesday when 'W' was pressed.  After
  563.    all appropriate days are lit, use the [F5] key as always to add a note.
  564.    It will then come up every week on that day (but will NOT cause the days
  565.    to be double-boxed.  Only individual appointments do that.)
  566.  
  567.    To delete all occurrences of a given note created with the W key,
  568.    you must first highlight the original day of the week on which the
  569.    note was created (by going to the day of the week and hitting W as
  570.    before) then use [F3] and [Ctrl][End] as usual.
  571.     Page 11
  572.  
  573.  
  574.    ********** JUDY IN THE BACKGROUND **********
  575.  
  576.  
  577.    LOADING JK.COM
  578.  
  579.    When you typed JUDY (to invoke JUDY.BAT), the full-screen JudyK
  580.    program appeared. After you exited, the background portion of JUDY
  581.    (called JK) was unloaded and re-loaded.  JK.COM needs to be loaded
  582.    in order for it to take into account any changes in your calendar
  583.    as performed by JudyK.
  584.  
  585.    This is why putting both the lines
  586.        JUDYK       (or "JUDYK/Q" for no screen display)
  587.        JK
  588.    in your AUTOEXEC.BAT is suggested.  It assures that the JK portion
  589.    of JUDY will be loaded properly into memory.  If you do not use the
  590.    JUDY batch file, or do not have the line "JK" in your AUTOEXEC.BAT
  591.    file, simply type "JK" (no quotation marks) at the DOS prompt to
  592.    load JK into memory.
  593.  
  594.    When JUDY loads, she responds with the line
  595.  
  596.              JUDY is here. Call me anytime with the Double Shift.
  597.  
  598.    She also immediately puts a clock in the upper right corner. (See CLOCK
  599.    below.)  You now have JUDY running under all your other software, until
  600.    the system is re-booted.  Wherever you wander in your computer, JUDY
  601.    will follow you, staying quietly in the background, maintaining your
  602.    clock, and waiting. Two things can bring her up front. If she has a
  603.    message for you, she'll let you know. Or if you want her, you can
  604.    always summon her up.
  605.  
  606.  
  607.    UNLOADING JK.COM
  608.  
  609.    If you need to load JK and she is already in memory or if for some
  610.    other reason you wish to take JK.COM out of memory, you can do so by
  611.    typing
  612.        JK /u
  613.    at the DOS prompt.  This will free up the memory she occupied and
  614.    prevent her from possibly clashing with incompatible software.  It
  615.    will also of course prevent her from reminding you of your messages.
  616.  
  617.    JUDY had been carefully created to work with as wide a range of other
  618.    software as possible, but because of certain limitations of DOS and
  619.    other non-compatible "IBM-compatibles", programs which reside in memory
  620.    all carry some risk of incompatibility with other programs.  JK.COM,
  621.    therefore, cannot be guaranteed to work with every other DOS program in
  622.    the world.  This is why the ability to unload JK.COM from memory was
  623.    included.  It allows you to, say, modify a batch job which runs the
  624.    incompatible application to first unload JK, run the application and
  625.    then load JK back up.  This would be accomplished with lines in your
  626.    batch job similar to:
  627.  
  628.        JK /u  (to unload JUDY)
  629.            ... (your application is called here )
  630.        JK    (to load her back up)
  631.     Page 12
  632.  
  633.  
  634.      WHEN JUDY CALLS
  635.  
  636.    When JUDY (or, that is, JK.COM) has a message for you, she will beep.
  637.    She will also interrupt whatever process you are engaged
  638.    in. The rest of the computer's operations, (except for life-support
  639.    functions) are suspended while JUDY presents her message, which appears
  640.    as a bright, underlined or colored line of text in the center of the
  641.    screen. (You can change the color and position in the detailed set up,
  642.    described in the appendix.)  You acknowledge the message with a [Esc]
  643.    or [Return]. The JUDY message will disappear, the screen will be repaired,
  644.    and the interrupted software will resume. The message is then considered
  645.    delivered and JUDY will reuse its space.
  646.  
  647.    Alternatively, the 's' key can be used as a 'snooze bar', a
  648.    procrastination feature that postpones the message for five minutes.
  649.    (This is customizable also.  See section on CONFIGURATION in the
  650.    Appendix.)
  651.  
  652.    Any keystroke other than [Esc], [Return], 's', or 'S' will be ignored
  653.    and thrown away. This insures that you will not miss the message.
  654.  
  655.    NOTE: Once again, because of problems DOS can have with the demands
  656.    of memory resident programs such as JUDY, there is a chance that JUDY
  657.    will not restore certain application screen displays properly (but
  658.    although it might interfere with the display it will not interfere
  659.    with the application's actual operation).  There is little, if anything,
  660.    the creators of pop-up utilities (known as TSRs) can do to avoid this
  661.    possibility. Many newer applications anticipate such problems from TSRs
  662.    and include a method of repainting the screen display should it be
  663.    changed.  If your application does not have this re-paint feature yet
  664.    JUDY interferes, you can still temporarily unload JK.COM before running
  665.    the application according to the directions given above.
  666.  
  667.  
  668.  
  669.      WHEN YOU CALL JUDY
  670.  
  671.    The "Double Shift" calls JUDY to the foreground of your screen.
  672.    To do the double shift, you hold down both left and right shift
  673.    keys at once.  Press them firmly down, and hold 'em in until JUDY
  674.    presents herself. She'll appear with this menu:
  675.  
  676.           Memo     Jot    Review    Clock   [Esc]
  677.           
  678.    You choose these functions by tapping the first letter, or hitting
  679.    the ESC key to quit. For example, the 'c' key, shifted or not, will
  680.    give you the CLOCK. After performing the chosen function, JUDY will
  681.    drop away, returning you to exactly where you were when you called her.
  682.  
  683.    These are the JUDY background functions:
  684.  
  685.     MEMO:
  686.       MEMO is used to add a message to today's list. MEMO puts notes
  687.       into current memory only; it does not write to disk. Like everything
  688.       in memory, MEMO messages vanish when the computer is turned off or
  689.       rebooted.  So they should only be used for SHORT TERM notes.  For
  690.       more permanent notes use JOT.
  691.     Page 13
  692.  
  693.  
  694.       To set a MEMO, call JUDY with the Double Shift. When she appears,
  695.       hit 'm' for Memo. Then fill in the time of the message. (See
  696.       TELLING JUDY THE TIME in the MISCELLANEOUS section below.)  After
  697.       the time has been filled in, a blank line will appear. Type your
  698.       message in the line (using left, right and backspace keys to correct
  699.       errors). Then hit either [Esc] or [Return]. The message is now tucked
  700.       away. It can be checked with REVIEW, and when the time comes, you'll
  701.       be hearing from JUDY.
  702.  
  703.  
  704.     REVIEW:
  705.       This function allows you to check upcoming messages, and to cancel
  706.       any of them. To REVIEW, use the Double Shift, then press 'r'.
  707.  
  708.              [Del] kills, other keys advance
  709.  
  710.       is then displayed.  From this point on, you press any key to see the
  711.       next message. They are presented one at a time in chronological order,
  712.       and then JUDY drops away. If there are no messages JUDY disappears
  713.       immediately. To cancel a message, simply press the [Del] key while it
  714.       is onscreen.  The message is eradicated from memory.  This is NOT the
  715.       same, however, as permanently erasing a note from your appointment
  716.       calendar.  To do that, you must use JudyK (see JUDY IN THE FOREGROUND).
  717.  
  718.     CLOCK:
  719.       JUDY presents a 12-hour hour-minute-second clock, which she updates
  720.       each second. If the position of the clock, or its existence, is not
  721.       desired, the CLOCK function allows you to change it temporarily.
  722.       Call JUDY with the DoubleShift, and tap the 'c' key.  Now you can
  723.       place the clock anywhere on the screen using the arrow keys. Or you
  724.       can remove the clock with the [Ins] key. If the clock is already gone,
  725.       the [Ins] key will restore it. When done, the [Return] or [Esc] key
  726.       will bring you back to your main task.
  727.       
  728.       NOTE: This placement change only lasts until you change it again
  729.       or until reloading JK (say, by rebooting).  To make a permanent
  730.       change, reconfigure JUDY with the "JUDYK /S" command, explained
  731.       below in the appendix.
  732.  
  733.     JOT:
  734.       JOT is JUDY's access to the disk, and thus to long term storage.
  735.       Anything you add with the JOT command gets placed temporarily into
  736.       the "SCRATCH.PAD" file in the JUDY area. (Read the section on
  737.       JUDY'S AREA for a discussion of disk usage.)
  738.  
  739.       JOT, via the Double Shift, then 'j', presents you with the menu:
  740.  
  741.           Calendar   Address   Expense   Idea
  742.  
  743.       The Calendar option allows you to leave a message for any time this
  744.       decade. After filling out the time and date (see below), a line
  745.       appears into which you drop your message. Note that even if a message
  746.       is for today's date, JUDY will NOT remind you of it, until it has
  747.       been "digested" by JudyK. On the other hand, a JOTted date even in
  748.       the past, will become part of your calendar and data files.  So if
  749.       you JOT a message for today's date (though MEMO is better) reboot
  750.       your computer or unload and reload JK (done automatically by JUDY.BAT).
  751.    Page 14
  752.  
  753.  
  754.       Choosing Address, Expense, or Idea simply marks the succeeding
  755.       message for eventual filing into one of three bins: ADDRESS.JK,
  756.       EXPENSES.JK, IDEAS.JK.  The message is actually sorted and placed
  757.       into one of these data files later by JudyK.  The date and time of
  758.       the note's creation are recorded with it, and tacked on to the end
  759.       of the line of text when saved to disk.  Unlike the CALENDAR notes,
  760.       the "Address," "Expense" and "Idea" data files are text files, which
  761.       means they can then be read with a text editor, and reviewed with the
  762.       Lookup Utility.  So using JOT is the way to note an expense or
  763.       telephone number that you might later summon with the Lookup Utility.
  764.  
  765.  
  766.     DOS LOCK:  Flashing Triangles in Clock Display:
  767.  
  768.     You may notice after using JOT that some downward pointing triangles
  769.     are in the clock display.  This indicates that JUDY wants to download
  770.     the most recent JOT to disk, but DOS is locked.  DOS is locked during
  771.     certain critical states, and it should not be interrupted. Oddly, one
  772.     of those states is when you are 'sitting at the prompt'; ie: just in
  773.     DOS, with no application program running.
  774.  
  775.     You don't have to do anything, JUDY will wait for the best time and
  776.     then perform the disk write. Just do not turn off the computer before
  777.     she's had her chance. (You can usually unlock DOS with any screen
  778.     activity such as doing a DIR command or hitting [Ctrl][Break].)
  779.  
  780.  
  781.    ********** MISCELLANEOUS **********
  782.  
  783.  
  784.      TELLING JUDY THE TIME:
  785.  
  786.    When writing the time during the creation of a note in either
  787.    foreground mode (JudyK) or background mode (JK), please note that JUDY
  788.    accepts both 12 hour or 24 hour ("military") time. If there is an
  789.    ambiguity, she will ask for 'a' or 'p' (am/pm). JUDY takes care of
  790.    all punctuation; you need only give her the digits, (and 'a' or 'p').
  791.    She ignores illegal digits.  Also you need not specify everything about
  792.    the time if you want to go along with certain defaults.  Hitting
  793.    [Enter] at certain times results in the following defaults:
  794.  
  795.        Before first digit:  No time attached to message.
  796.        Before the minutes:  Even o'clock, (eg: 7:00)
  797.        Before am/pm:        "Normal office" hours. (8:31 am to 8:30 pm)
  798.  
  799.  
  800.  
  801.      TELLING JUDY THE DATE:
  802.  
  803.    When using the Jot-Calendar feature, you will need to enter a date.
  804.    JUDY starts you with the current date, allowing you to overwrite it.
  805.    You can change as much of the date as you like, scooting around with
  806.    the left and right arrows.  As soon as you hit the [Enter] key, it
  807.    is accepted. For instance, if you want to leave a message for today's
  808.    date you don't type in anything--just hit [Enter].  Or change a single
  809.    digit and [Enter] to leave a message for tomorrow.
  810.    Page 15
  811.  
  812.  
  813.    The date is day/month-name/'year. The day is filled in as two digits.
  814.    Note that the first digit cannot exceed 3. The month is selected using
  815.    the [Up] and [Down] cursor keys to scroll through the month-names, and
  816.    hitting the [Enter] key to pick one.
  817.  
  818.  
  819.    DIARY FILES
  820.  
  821.    JUDY will use all available memory up to about 128K to hold the
  822.    largest possible Calendar file.  When there is no more room, she
  823.    automatically spills off the oldest inactive appointments into nicely
  824.    formatted Diary files. She can no longer read them but you can, with
  825.    any word processor. There is a separate file for each month.  JUDY will
  826.    explain to you what she is doing when she does it.
  827.  
  828.  
  829.    JUDY SWITCHES
  830.  
  831.    The following "switches" are different command parameters you can
  832.    give JudyK when running it from DOS, depending on what you wish to do.
  833.  
  834.     Quick:Judyk /Q
  835.    Do the filing and exit, no fullscreen display
  836.    Useful in AUTOEXEC.BAT where the calendar display is unwanted.
  837.  
  838.     Setup:Judyk /S
  839.    Tailor JUDY to user's parameters. See section in appendix on
  840.    CONFIGURATION.  Useful as your equipment, or your taste changes.
  841.  
  842.     Fresh Files:Judyk /F
  843.    Any JUDY files not present will be created.
  844.    Useful after a disk disaster, or simply to start from scratch.
  845.    Use the subswitch /O (Judyk /f /o) to overwrite (kill) existing files.
  846.  
  847.     Identify:Judyk /I
  848.    JUDY identifies herself, her owner, her condition.
  849.    Useful if you've gotten confused.  If the version you have is a
  850.    shareware "clone" (with limited lifespan) it will be indicated
  851.    here.
  852.  
  853.    Page 16
  854.  
  855.  
  856.    ********** THE JUDY LOOKUP UTILITY **********
  857.  
  858.  
  859.     You'll find JUDY's ability to LOOKUP items quite versatile.  The
  860.     following is a list of some of the things the LOOKUP utility gives
  861.     you:
  862.  
  863.    a) Instant access to JUDY's own ADDRESS, EXPENSES and IDEAS
  864.       files.
  865.  
  866.    b) The ability to check either just the beginning of a file
  867.       entry or anywhere in the file for the keyword.
  868.  
  869.    c) The ability to look-up entries by the JUDY date stamp,
  870.       which is recorded by JUDY at the time of the entry's creation.
  871.  
  872.    d) The option of saving the list of successful matches to a
  873.       separate LOG file, or in fact any file you wish for organizing
  874.       or printing purposes.
  875.  
  876.    e) Access to simply ANY ASCII text file for use with more than
  877.       just names and addresses.
  878.  
  879.  
  880.    ********** USING LOOKUP **********
  881.  
  882.    THE SCREEN
  883.  
  884.    Upon hitting the [F8] key in JUDY (or by typing "phone" at the DOS
  885.    command prompt) you are confronted with the LOOKUP screen, which
  886.    is different from the rest of JUDY.  Not to worry.  The LOOKUP
  887.    screen is very straightforward.  It is divided into 3 main
  888.    areas:
  889.  
  890.    a) The PARAMETERS Area
  891.  
  892.       This is the area at the top where you determine what it is you
  893.       want to search for.  You do so by placing information
  894.       in each of the three "fields" or boxes.  These fields indicate
  895.       HOW you want to search for an item or keyword (the "Search Mode"
  896.       field), WHAT that item is (the "Item to Search For" field),
  897.       and WHERE to look for it (the "From File" field).
  898.  
  899.       Each of these fields can be highlighted (activated) by using the
  900.       [Right]/[Left] arrow keys or by hitting the appropriate function key.
  901.  
  902.  
  903.     b) The MATCHES Area
  904.  
  905.        This is the large black window in the center of the screen.  It
  906.        is where each text entry containing a match to the given keyphrase
  907.        or date is displayed.  If not all the matches can be displayed at
  908.        once, the word "MORE" appears at the bottom of the window indicating
  909.        that you will need to scroll through the matches to see them all.
  910.  
  911.        You cause a search to be performed by hitting the [Return] key.
  912.    Page 17
  913.  
  914.  
  915.     c) The MESSAGES Area
  916.  
  917.        This blue area at the bottom of the screen displays various
  918.        prompts and help messages.  LOOKUP will display a message here
  919.        whenever it beeps due to an error or when needing some additional
  920.        information.  The line of text below it at the bottom of the
  921.        screen never changes, and is there strictly as a reminder of
  922.        which function keys do what.
  923.  
  924.  
  925.  
  926.    ********* F1 --  SEARCH MODE **********
  927.  
  928.    One of LOOKUP's strengths is that it is more than just a simple
  929.    text search utility.  You can place restrictions on the way
  930.    LOOKUP will determine a match by changing the "Search Mode"
  931.    parameter.
  932.  
  933.    To change the Search Mode parameter, use the [Up] and [Down] arrow keys.
  934.    This will scroll you through the following options.
  935.  
  936.    a) TEXT
  937.      Makes LOOKUP assume that whatever you type into the "Search For" field
  938.      is an alpha-numeric text fragment and will look EVERYWHERE in the file
  939.      for it.
  940.  
  941.      This is the simplest way of determining matches.  If the given keyword,
  942.      number or phrase (ignoring upper/lower case) is found, the entire entry
  943.      is added to the list of matches.  ("The entire entry" here is usually
  944.      only one line of text, complete with time and date stamp, as created by
  945.      JUDY. It doesn't have to be, however.  See the section below on
  946.      SEARCHING for an explanantion on how to have multiple-line entries.)
  947.  
  948.      This is the default setting because it is the most common
  949.      way you will probably do your searches.  It is the easiest
  950.      way to look up phone numbers, addresses and names.  Searching
  951.      in TEXT mode frees you from having to organize your entries as
  952.      you jot them down in JUDY.
  953.  
  954.    b) BEGINNING
  955.      A lot like TEXT mode in that it does nothing special to the
  956.      text fragment you give it to look for.  The difference is
  957.      that in BEGINNING mode, LOOKUP finds only those entries that
  958.      have the given keyword or number at the very beginning of the
  959.      entry.  This is useful if you have organized your entries
  960.      with this in mind.  You might preface each entry as you
  961.      create it in JUDY with a special word or name determining its
  962.      category so that later with LOOKUP you can refer to it in
  963.      BEGINNING mode for that specific category.  It's up to you.
  964.  
  965.    c) DATE
  966.      This mode searches entries by the date stamped onto the end of
  967.      the line.  Whenever you JOT something
  968.      down in JUDY, she dutifully records the time and date you did
  969.      so and adds it on to the end of the line of text you jotted.
  970.     Page 18
  971.  
  972.  
  973.      The DATE mode exploits this fact.  When in this mode, LOOKUP
  974.      takes the date you give it, converts it into the proper
  975.      JUDY format and then compares it to the tail end of each
  976.      file entry. This way you can call up all the expenses or
  977.      ideas or phone numbers you recorded on a specific date.
  978.  
  979.      JUDY of course writes down the date in a very specific and
  980.      consistent format as she adds it onto your entry, but you
  981.      don't have to know what that is to use LOOKUP.  LOOKUP will
  982.      take virtually ANY standard North American date format,
  983.      including * and ? wildcards.  But the following rules apply:
  984.  
  985.       -- a month, day and year must all be specified
  986.       -- the month, day and year must be separated by
  987.          either a slash, space, period, comma or hyphen
  988.       -- The month can come second ONLY if you spell it
  989.          out, otherwise the first number is always
  990.          assumed to be the month
  991.       -- No letters are allowed as part of the day and year
  992.       -- Only the last two digits of the year are considered
  993.  
  994.       To see what all that means, just look at the following examples.
  995.       Each of them is an acceptable form for a date. Note also how the
  996.       wildcards are used, for looking up multiple dates.
  997.  
  998.            ACCEPTABLE DATE FORMATS:
  999.  
  1000.            2/3/90   (assumes month = 2 as per American custom)
  1001.            02 3 90
  1002.            2 03 1990
  1003.            Feb 3, 1990
  1004.            03-February.90
  1005.            2 * 1990    (every day of Feb. 1990)
  1006.            Feb 1? 90   (every two-digit day beginning with a 1)
  1007.            February ? * (any one-digit day in Feb. of every year)
  1008.  
  1009.  
  1010.  
  1011.    ********** F2 -- SEARCH FOR **********
  1012.  
  1013.    This can be any alpha-numeric letter, word or phrase of up to 80
  1014.    characters.  Each entry that contains it will be placed on the list
  1015.    of matches.
  1016.  
  1017.    LOOKUP is case insensitive, meaning that it disregards whether the
  1018.    letters you type in are uppercase or lowercase when determining a match.
  1019.    Therefore you don't have to worry about how the original was typed.
  1020.  
  1021.    You do have to concern yourself with spaces, however.  LOOKUP treats
  1022.    these like any other letter, so if you accidentally type some leading
  1023.    or trailing spaces along with the search text LOOKUP will not find
  1024.    the original text if it did not contain such spaces.
  1025.    Page 19
  1026.  
  1027.  
  1028.    When modifying the contents of the "Search For" field, please note
  1029.    that if the cursor is at the head of the text and you type in a new
  1030.    letter, the entire line of text is replaced.  This is to speed up
  1031.    the process of typing in something new.  If you are at the very end
  1032.    of the text and hit the [Right] arrow key you'll exit the "Search For"
  1033.    field.
  1034.  
  1035.    The [Up] and [Down] arrow keys along with [PgUp], [PgDn], [Ctrl][PgUp]
  1036.    and [Ctrl][PgDn] will scroll the MATCHES window an entry at a time (or
  1037.    a page at a time) only when the "Search For" field is active.  In other
  1038.    fields the arrow keys cause you to scroll through options.
  1039.  
  1040.  
  1041.    ********** F3 -- FROM FILE **********
  1042.  
  1043.    This is the name of the file that contains the entries through which
  1044.    you wish to search.  It must be an ASCII text file for LOOKUP to work
  1045.    properly.  It can be of any size.
  1046.  
  1047.    Since LOOKUP is designed to work directly with JUDY, it assumes the
  1048.    files you will most likely be looking through are the standard JUDY
  1049.    text files ADDRESS, EXPENSES and IDEAS.  These are files you write to
  1050.    when calling up JUDY via the "Double-Shift" option and select JOT.
  1051.    Each entry in these files is an 80-character line of text containing
  1052.    the words you typed followed by JUDY's own time and date stamp.  Since
  1053.    you might also often be using the LOG file created by LOOKUP, this is
  1054.    one of the standard "From File" options as well.
  1055.  
  1056.    To search through any one of these files, highlight the
  1057.    "From File" field and use the [Up] and [Down] arrow keys to scroll
  1058.    through the choices until the file you want to search appears
  1059.    in the field.
  1060.  
  1061.    If you want to look at any other file, just type in its name at
  1062.    any time.  Once you do, this new filename is added to the list
  1063.    of options so that you can scroll back to it later.  Upon
  1064.    startup of LOOKUP there is a blank slot in the list of filenames
  1065.    available for just this purpose.  Each time you type in your
  1066.    own filename this "free slot" is replaced with the most recently
  1067.    entered name.
  1068.  
  1069.    If a pathname or extension is not specified as part of the
  1070.    file specification, LOOKUP assumes the file resides in a
  1071.    \JUDY directory (which is NOT necessarily the current directory
  1072.    and NOT necessarily "the" JUDY area.  If you installed JUDY in
  1073.    some directory other than one specifically named \JUDY, then
  1074.    LOOKUP will not be able to find the .JK files immediately.  You
  1075.    will have to supply the different path as part of the filename).
  1076.  
  1077.    LOOKUP also assumes the file has the extension ".JK".
  1078.    If you type in your own filename please specify the path and
  1079.    extension if different from these defaults.
  1080.     Page 20
  1081.  
  1082.  
  1083.    ********** [Return] Key -- SEARCHING **********
  1084.  
  1085.    Hitting the [Return] or [Enter] key causes LOOKUP to perform its
  1086.    search.  It won't do anything at all , however, if none of the
  1087.    parameters has been changed since the last search.
  1088.  
  1089.    If you have already done a search and a list of matches
  1090.    resides in the MATCHES window, LOOKUP will ask you if you
  1091.    want to append the results of this new search on to the
  1092.    present list.  You must type Y or N, with Y (yes) meaning
  1093.    to append the results.  This way you can build up a special
  1094.    list as the result of several different searches, and save the
  1095.    final result to disk as the LOG file.  Most of the time,
  1096.    however, you will find yourself doing only one search and then
  1097.    exiting.
  1098.  
  1099.    If LOOKUP finds the target text or date, it displays the entire
  1100.    entry which contains it.  In almost all cases this entry will simply
  1101.    be that single line of text read from the file.  But it does not
  1102.    have to be.
  1103.  
  1104.    As mentioned in earlier sections of this documentation you
  1105.    can look in ANY text file for matches--even one you have
  1106.    created yourself on a standard ASCII text editor (such as
  1107.    "edlin"--if you are masochistic--or a commercial word processor
  1108.    running in ASCII mode).  If you create the file yourself you
  1109.    can have multiple-line entries by simply ending each line (except
  1110.    the last one) with an underscore ('_').
  1111.  
  1112.    LOOKUP, upon finding a match, looks to the end of the line
  1113.    for an underscore.  If one is found it automatically adds the
  1114.    subsequent line of text from the file to the list until the
  1115.    lines quit ending in underscores.  This allows you to create
  1116.    your own simple database of multiple line entries, such as
  1117.    the following:
  1118.  
  1119.        Shrub, Georgette_
  1120.        1000 Darkniss Point_
  1121.        Blackshack, WA 20001
  1122.  
  1123.        Bonaparte, Leon_
  1124.        2 Sacred Blue, Ave._
  1125.        Oolala, FL 18120             etc. etc.
  1126.  
  1127.    If you were to look up "Shrub," for instance, LOOKUP would
  1128.    display all three lines in the list as a single entry.
  1129.  
  1130.  
  1131.    ********** F6 -- SAVING TO A FILE ***********
  1132.  
  1133.    Once you have a list of matches displayed on the screen,
  1134.    you can write it out to a file by hitting [F6].  This file
  1135.    could then be printed out by copying it to your printer from
  1136.    DOS (using the command "copy <filename> PRN").  Or you could
  1137.    even use LOOKUP on it as well for further refinement in your
  1138.    search.
  1139.     Page 21
  1140.  
  1141.  
  1142.    By default, LOOKUP will write the results under the name
  1143.    LOG.JK in a directory specifically named \JUDY.  If that is
  1144.    what you want (and it almost always is), just hit [Return]
  1145.    to confirm the save.
  1146.  
  1147.    If you want to save the list under some other name (even
  1148.    possibly under the name "address" or "expenses" or "ideas")
  1149.    then you need to type it into the field supplied in the
  1150.    MESSAGES area for this purpose.
  1151.  
  1152.    If you do, LOOKUP still assumes that the file will go into
  1153.    the \JUDY directory and have the .JK extension (as is the
  1154.    case with the "From File" field).  If you want the file
  1155.    to go anywhere else or have another extension, you need to
  1156.    type in the path and extension explicitly.
  1157.  
  1158.    If the file already exists, LOOKUP will tell you so and ask
  1159.    if you want to overwrite the existant file.  If you indicate
  1160.    Y (for yes) then the current file with the given name will be
  1161.    replaced with the new list.  Otherwise, LOOKUP won't save
  1162.    anything to disk.  You can then hit [F6] and type in a different
  1163.    name this time if you wish.
  1164.  
  1165.    ********** F10 -- EXITING ***********
  1166.  
  1167.    At any time you may hit the [F10] key to exit LOOKUP and return
  1168.    to JUDY (or DOS if you ran LOOKUP from the DOS command prompt).
  1169.  
  1170.    LOOKUP will first remove the current Matches list from memory
  1171.    (if any list exists) without saving it to disk.  It will then
  1172.    exit.
  1173.  
  1174.     ********** EXAMPLES **********
  1175.  
  1176.      a) By default LOOKUP is set to do "Text" searches from
  1177.         "address.jk."  If you simply want to look up someone's
  1178.         phone number from the address file, then this is perfect.
  1179.         Just type in the name--ignoring upper and lower case--in
  1180.         the "Search For" field and hit RETURN.  LOOKUP displays
  1181.         the line or lines containing the person's name so you
  1182.         can read the number.  Hit [F10] to exit.
  1183.  
  1184.      b) Suppose Edith kept records concerning Christmas gift
  1185.         ideas by jotting them down in the "ideas" file in JUDY.
  1186.         Each time she added an idea she prefaced it with the
  1187.         recipient's first name.  Now she wants to see a list of
  1188.         all the ideas she had for Ted.  First, she types the word
  1189.         TED (upper or lower case) into the "Search For" field.
  1190.         Then she highlights the "From File" field and hits the [Up]
  1191.         arrow key until IDEAS is displayed.  She highlights the
  1192.         "Search Mode" field and scrolls until BEGINNING
  1193.         is shown (so as to search only those ideas beginning with the
  1194.         word "ted" and not any ideas that may be ABOUT Ted and have his
  1195.         name imbedded in the middle of the line).
  1196.  
  1197.         She hits [Return].  Presto!  All the ideas starting with the
  1198.         word "Ted" are displayed.  She saves this out to a file, and
  1199.     prints it up for an instant Christmas list.
  1200.      Page 22
  1201.  
  1202.  
  1203.      c) Let's say that you use JUDY to jot down your household
  1204.         expenses.  At the end of the year you want to see what
  1205.         you spent in March.  No sweat.  Simply set the "Search
  1206.         Mode" field to DATE, and the "From File" to EXPENSES.
  1207.         Then, taking advantage of LOOKUP's ability to accept wild-
  1208.         cards in its dates, you type in "March * 90" (no quotes,
  1209.         of course) in the "Search For" category, meaning "search
  1210.         for all entries dated any day of March 1990."  Hit [Return].
  1211.         Shazam!  All the single line entries you jotted down with
  1212.         JUDY in the EXPENSES file during the month of March 1990
  1213.         are called up.  Hit [F6] and name the output file "MARCH"
  1214.         and you'll have a separate record of these expenses. 
  1215.         (You might even subsequently search through this "March" file
  1216.         for all entries containing the phrase "slush fund" or whatever
  1217.         for a futher breakdown of your expenses.)
  1218.  
  1219.    ********** COPYRIGHT and LISCENSING AGREEMENT **********
  1220.  
  1221.    JUDY is copyrighted material, and of course it is illegal to
  1222.    distribute unauthorized copies, whether for fun or profit.  What your
  1223.    hard-earned 30 bucks has bought you is merely the right to USE the
  1224.    software.  You may make safety copies for yourself, naturally, but
  1225.    beyond such simple archival copies you must treat this software as you
  1226.    would any other singular material object: it cannot be used by more
  1227.    than one person on one computer at any given time.  You must not allow
  1228.    for even the possibility of it being used by two people simultaneously.
  1229.  
  1230.  GUARANTEE AND DISCLAIMER:
  1231.  
  1232.    We hope you enjoy JUDY.  If you're unhappy with JUDY, send the original
  1233.    diskette and documentation back to Interfact Software within 30 Days of
  1234.    its receipt and we'll cheerfully refund your money.
  1235.  
  1236.    Other than that, there are no warranties express or implied.
  1237.  
  1238.  
  1239.    ********** APPENDIX **********
  1240.  
  1241.   DETAILED JUDY CONFIGURATION:  Upon invocation by Judyk/s or during first
  1242.   powerup of JudyK.  NOTE: THESE CHANGES ARE NOTICABLE ONLY UPON THE NEXT
  1243.   TIME YOU LOAD JK.COM.
  1244.  
  1245.       Where should the clock be? (Use Cursor keys)
  1246.    If you don't like where the clock comes up (the upper right hand
  1247.    corner), you can change this home position by pushing around the
  1248.    marker with the cursor keys.  This changes where the clock shows up
  1249.    BY DEFAULT.  If you want to change the clock position at any time during
  1250.    a particular session, call JUDY via DoubleShift and use the "Clock"
  1251.    command there.
  1252.    typical answer: (Move the marker with the four cursor keys, then press
  1253.    [Enter].)
  1254.  
  1255.      Where should Judy appear?
  1256.    Similarly, you indicate a position on the screen. Notice that the
  1257.    legal area for the marker is constrained to an area smaller than the
  1258.    full screen.
  1259.    typical answer: (Move the marker with the four cursor keys, then press
  1260.    [Enter].)
  1261.     Page 23
  1262.  
  1263.  
  1264.      What color code for clock? (Use Cursor keys)
  1265.    There are 256 available colors, which you can scroll through. The
  1266.    order of the colors can be found in Table C of the IBM Tech Ref
  1267.    Manual.  Monochrome owners will find that a great many colors are
  1268.    exactly the same as one another, and that scrolling through them is
  1269.    rather boring. For both color and monochrome colors 128-255 are all
  1270.    blinking.
  1271.    typical answer: (View colors with arrows, then select by pressing [Enter].)
  1272.  
  1273.    
  1274.       How about a color code for Judy menus?
  1275.    This color is the one in which you want JUDY to present herself when
  1276.    she interrupts you from the background.
  1277.    typical answer: (View colors with arrows; select by pressing [Enter].)
  1278.  
  1279.     And for urgent Judy messages?
  1280.    This is the color in which all highlighted words used by JUDY will be
  1281.    presented.  This means not only urgent text, but other non-emergency
  1282.    characters, most notably the cursor.
  1283.    typical answer: (View colors with arrows; select by pressing [Enter].)
  1284.  
  1285.    
  1286.     How long is the snooze period?  {in minutes}
  1287.    The snooze period is the time which you get to procrastinate.  When
  1288.    JUDY interrupts you with a message and you hit 'S' or spacebar to
  1289.    postpone that message a few minutes, the Snooze Period will determine
  1290.    that interval.
  1291.    typical answer: 5
  1292.  
  1293.    
  1294.     Do you wish to change the "Double Shift" pattern?
  1295.    If for some reason you want to call JUDY with something other than
  1296.    the traditional double-shift (left and right shiftkeys), you can
  1297.    change that.  Simply answer Yes, then set any combination of
  1298.    [Left Shift], [Right Shift], [Alt] and [Ctrl].
  1299.    Use [Enter] to accept, or [Del] to clear the combination and try again.
  1300.  
  1301.    
  1302.      What type of printer? { Vanilla=0  Epson=1 }
  1303.    This regulates the type of control codes which JUDY will use to
  1304.    create special printer effects when making hardcopy of your schedule.
  1305.    The Vanilla option attempts no printer effects, it sends only pure
  1306.    ASCII code.
  1307.    typical answer: 0
  1308.  
  1309.    
  1310.      Which printer port? { 1, 2, 3 }
  1311.    Is your printer on LPT1, LPT2 or LPT3? Simply press the proper number.
  1312.    NOTE: the default is given as LPT1 the first time you configure JudyK,
  1313.    but technically speaking the default is PRN, and if you specifically
  1314.    want PRN (and not LPT1:, just hit [Enter] to stick with the default.
  1315.    typical answer: [Enter]
  1316.     Page 24
  1317.  
  1318.  
  1319.     What is the name of your Phone Manager? { PHONE }
  1320.    This is the name of the program that will be invoked whenever you
  1321.    hit [F8] in JudyK.  Normally this is the Lookup Utility (as the
  1322.    Lookup Utility's actual name is PHONE.EXE).  If you want to use
  1323.    some other manager or change the name of the Lookup Utility, type
  1324.    in the new name now.
  1325.    typical answer: [Enter] (to use default Lookup Utility)
  1326.  
  1327.  
  1328.    ********** ERROR MESSAGES **********
  1329.  
  1330.      'Bad disk; fix & hit key. Or Esc.'
  1331.    When you loaded JK, the JUDY disk was not the default
  1332.    drive.  Or the JUDY disk is damaged. Replace the disk, hit a key,
  1333.    and it will re-attempt to load. If you use [Esc], JUDY will install
  1334.    herself, but without any of today's messages. She will use Drive B:
  1335.    as her home drive.
  1336.  
  1337.      'Sorry,   my memory is full now. '
  1338.    JUDY can only hold sixteen pending "today's" messages.
  1339.    There are sixteen active ones already. Delete one with the REVIEW
  1340.    function if you want.
  1341.  
  1342.      'Cannot write. Hit [Esc] to free.'
  1343.    JUDY cannot jot a note into her directory. Most likely, the
  1344.    wrong floppy is in the drive or the disk is full. Replace the
  1345.    disk, if necessary, and hit a key.  Otherwise abort out with [Esc].
  1346.    Note will not be written.
  1347.  
  1348.      'Cannot create scratch.pad. hit [Esc]'
  1349.    JUDY cannot open up a file in her directory. Probably the
  1350.    directory is full or it is nonexistent. Hit [Escape] and investigate.
  1351.    Your note will not be written.
  1352.  
  1353.      'Judy's already here. Hit [Esc]'
  1354.    JK, the resident part of JUDY, is already in residence. There
  1355.    are few reasons for double loading JUDY, and it might create trouble.
  1356.    Troublemakers can force a doubleload with 'f'. (Be sure to configure
  1357.    different DoubleShift patterns as well.)
  1358.  
  1359.      'Version mismatch. Maybe trouble.'
  1360.    The JUDYK and JK files are not the same version number. Check
  1361.    the numbers during signon. This may or may not present problems.
  1362.  
  1363.      'Not now.'
  1364.    This message occasionally appears if you call JUDY during a
  1365.    time when the computer's operation should not be interrupted. Try
  1366.    again in a few seconds.
  1367.  
  1368.      'Error on LPT1:' 'IO ERROR' or 'OUT OF PAPER'
  1369.    These self-explanatory messages might appear during hardcopy
  1370.    printout. Usually your printer is turned off, off-line or out of paper.
  1371.    However be certain that the LPT number in the error message
  1372.    corresponds to your actual printer port.
  1373.     Page 25
  1374.  
  1375.  
  1376.      'This is not MY Calendar'
  1377.    You have gotten the wrong calendar.jk file in your system. You
  1378.    can delete it and then use Judyk/F to replace this (and any other
  1379.    missing files). JUDY clones will not read the files of another
  1380.    JUDY clone.
  1381.  
  1382.      'Cannot find file xxxx.jk'
  1383.    The requested file is not available. Do you have the proper
  1384.    disk mounted?  Or maybe \JUDY is not in your path.  If not, check
  1385.    the disk or change the path to include the proper directory.
  1386.    Otherwise, you may be missing some files.  Type 'Judyk/F' to replace
  1387.    the missing file with a clean slate .
  1388.  
  1389.    
  1390.    ***** FILES CREATED BY JUDY DURING CONFIGURATION *****
  1391.       (these files will therefore be in your \JUDY directory along with
  1392.        those listed in the READ.ME file on the Distribution Diskette)
  1393.  
  1394.     in the current directory:
  1395.  
  1396.       WHERE'S.bat: sample use of ADDRESS.jk with FIND.
  1397.             NOT needed if you use the Lookup Utility.
  1398.  
  1399.     in the the JUDY directory:
  1400.  
  1401.        ADDRESS.jk: list of addresses, readable by any text editor.
  1402.        EXPENSES.jk: list of expense, readable by any text editor.
  1403.        IDEAS.jk: idea 'heap',  readable by any text editor.
  1404.       *CALENDAR.jk: records appointments, only readable by JUDY
  1405.       *SCRATCH.pad: JK's notes to JUDYK
  1406.       *NOTE.pad: JUDYK's notes to JK
  1407.        MON'YR.LOG: (ie: JAN'95.LOG) Diary files, records of old events.
  1408.  
  1409.     *for internal use only
  1410.  
  1411.    
  1412.  
  1413.     Thank you.  That's all.
  1414.  
  1415.    
  1416.     Copyright Feb 1987 by Dov Jacobson, new_functions()
  1417.     Revised June 1990 by Chris Masters, interfact software
  1418.    
  1419.